Indexer sample


Windows Runtime
Controls, indexer
Windows RT
en-US
11/25/2013

This sample shows how to add, update, and retrieve items and properties from the indexer. Two methods of doing so are demonstrated. The first is using the ContentIndexer APIs to directly interface with the indexer. The second is writing .appcontent-ms files, which contain information to be indexed that the indexer will pick up once the file has been written.

The sample demonstrates these tasks:

  1. Add an item to the system index

    Uses the AddAsync method to make app content searchable in the system index.

  2. Update and delete items in the index

    Uses the UpdateAsync method to update an item and the DeleteAsync, DeleteMultipleAsync, and DeleteAllAsync methods to remove content from the system index.

  3. Get items from the system index by using a query

    Uses the CreateQuery and GetAsync methods to retrieve items from the system index.

  4. Check the revision number of the indexer

    Uses the Revision property and the app's LocalSettings to check if the app's expected revision number matches the actual index revision number.

  5. Add app content files to be indexed

    Copies app-specific files to the app's LocalState\Indexed folder to make app content searchable in the system index.

  6. Remove file content from the system index

    Deletes app-specific files from the app's LocalState\Indexed folder to remove app content from the system index.

  7. Get indexed file properties

    Uses the CreateFileQuery and CreateFileQueryWithOptions methods to query the system index for file properties.

To obtain an evaluation copy of Windows 8.1, go to Windows 8.1.

To obtain an evaluation copy of Microsoft Visual Studio 2013, go to Visual Studio 2013.

Note  For Windows 8 app samples, download the Windows 8 app samples pack. The samples in the Windows 8 app samples pack will build and run only on Microsoft Visual Studio 2012.

Related topics

ContentIndexer
ContentIndexerQuery
CreateFileQuery
CreateFileQueryWithOptions

Operating system requirements

Client
Windows 8.1
Server
Windows Server 2012 R2

Build the sample

  1. Start Visual Studio 2013 and select File > Open > Project/Solution.
  2. Go to the directory in which you unzipped the sample. Go to the directory named for the sample, and double-click the Visual Studio 2013 Solution (.sln) file.
  3. Press F7 or use Build > Build Solution to build the sample.

Run the sample

To debug the app and then run it, press F5 or use Debug > Start Debugging. To run the app without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.